home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / g_man / cat3 / OpenGL-ftn / fglcopytexsubimage1d.z / fglcopytexsubimage1d
Text File  |  1998-10-20  |  11KB  |  200 lines
  1.  
  2.  
  3.  
  4. ffffggggllllCCCCooooppppyyyyTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee1111DDDD((((3333GGGG))))       OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee       ffffggggllllCCCCooooppppyyyyTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee1111DDDD((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ffffggggllllCCCCooooppppyyyyTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee1111DDDD - copy a one-dimensional texture subimage
  10.  
  11.  
  12. FFFFOOOORRRRTTTTRRRRAAAANNNN SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  13.      SUBROUTINE ffffggggllllCCCCooooppppyyyyTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee1111DDDD( INTEGER*4 _t_a_r_g_e_t,
  14.                                       INTEGER*4 _l_e_v_e_l,
  15.                                       INTEGER*4 _x_o_f_f_s_e_t,
  16.                                       INTEGER*4 _x,
  17.                                       INTEGER*4 _y,
  18.                                       INTEGER*4 _w_i_d_t_h )
  19.  
  20.  
  21. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  22.      _t_a_r_g_e_t   Specifies the target texture.  Must be GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____1111DDDD.
  23.  
  24.      _l_e_v_e_l    Specifies the level-of-detail number.  Level 0 is the base image
  25.               level.  Level _n is the _nth mipmap reduction image.
  26.  
  27.      _x_o_f_f_s_e_t  Specifies the texel offset within the texture array.
  28.  
  29.      _x, _y     Specify the window coordinates of the left corner of the row of
  30.               pixels to be copied.
  31.  
  32.      _w_i_d_t_h    Specifies the width of the texture subimage.
  33.  
  34. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  35.      ffffggggllllCCCCooooppppyyyyTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee1111DDDD replaces a portion of a one-dimensional texture
  36.      image with pixels from the current GGGGLLLL____RRRREEEEAAAADDDD____BBBBUUUUFFFFFFFFEEEERRRR (rather than from main
  37.      memory, as is the case for ffffggggllllTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee1111DDDD).
  38.  
  39.      The screen-aligned pixel row with left corner at (_x, _y), and with length
  40.      _w_i_d_t_h replaces the portion of the texture array with x indices _x_o_f_f_s_e_t
  41.      through xoffset + width - 1, inclusive. The destination in the texture
  42.      array may not include any texels outside the texture array as it was
  43.      originally specified.
  44.  
  45.      The pixels in the row are processed exactly as if ffffggggllllCCCCooooppppyyyyPPPPiiiixxxxeeeellllssss had been
  46.      called, but the process stops just before final conversion.  At this
  47.      point all pixel component values are clamped to the range [0, 1] and then
  48.      converted to the texture's internal format for storage in the texel
  49.      array.
  50.  
  51.      It is not an error to specify a subtexture with zero width, but such a
  52.      specification has no effect.  If any of the pixels within the specified
  53.      row of the current GGGGLLLL____RRRREEEEAAAADDDD____BBBBUUUUFFFFFFFFEEEERRRR are outside the read window associated
  54.      with the current rendering context, then the values obtained for those
  55.      pixels are undefined.
  56.  
  57.      No change is made to the _i_n_t_e_r_n_a_l_f_o_r_m_a_t, _w_i_d_t_h, or _b_o_r_d_e_r parameters of
  58.      the specified texture array or to texel values outside the specified
  59.      subregion.
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ffffggggllllCCCCooooppppyyyyTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee1111DDDD((((3333GGGG))))       OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee       ffffggggllllCCCCooooppppyyyyTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee1111DDDD((((3333GGGG))))
  71.  
  72.  
  73.  
  74. NNNNOOOOTTTTEEEESSSS
  75.      ffffggggllllCCCCooooppppyyyyTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee1111DDDD is available only if the GL version is 1.1 or
  76.      greater.
  77.  
  78.      Texturing has no effect in color index mode.
  79.  
  80.      ffffggggllllPPPPiiiixxxxeeeellllSSSSttttoooorrrreeee and ffffggggllllPPPPiiiixxxxeeeellllTTTTrrrraaaannnnssssffffeeeerrrr modes affect texture images in exactly
  81.      the way they affect ffffggggllllDDDDrrrraaaawwwwPPPPiiiixxxxeeeellllssss.
  82.  
  83. EEEERRRRRRRROOOORRRRSSSS
  84.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____EEEENNNNUUUUMMMM is generated if _t_a_r_g_e_t is not GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____1111DDDD.
  85.  
  86.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is generated if the texture array has not been
  87.      defined by a previous ffffggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD or ffffggggllllCCCCooooppppyyyyTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD operation.
  88.  
  89.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is generated if _l_e_v_e_l is less than 0.
  90.  
  91.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE may be generated if _l_e_v_e_l>log  _m_a_x, where _m_a_x is the
  92.                                                    2
  93.      returned value of GGGGLLLL____MMMMAAAAXXXX____TTTTEEEEXXXXTTTTUUUURRRREEEE____SSSSIIIIZZZZEEEE.
  94.  
  95.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is generated if _y <  -b or if _w_i_d_t_h <  -b, where b is
  96.      the border width of the texture array.
  97.  
  98.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is generated if xoffset <  -b, or
  99.      (xoffset + width) > (w-b), where w is the GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____WWWWIIIIDDDDTTTTHHHH, and b is the
  100.      GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____BBBBOOOORRRRDDDDEEEERRRR of the texture image being modified.  Note that w
  101.      includes twice the border width.
  102.  
  103. AAAASSSSSSSSOOOOCCCCIIIIAAAATTTTEEEEDDDD GGGGEEEETTTTSSSS
  104.      ffffggggllllGGGGeeeettttTTTTeeeexxxxIIIImmmmaaaaggggeeee
  105.      ffffggggllllIIIIssssEEEEnnnnaaaabbbblllleeeedddd with argument GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____1111DDDD
  106.  
  107.  
  108. MMMMAAAACCCCHHHHIIIINNNNEEEE DDDDEEEEPPPPEEEENNNNDDDDEEEENNNNCCCCIIIIEEEESSSS
  109.      ffffggggllllCCCCooooppppyyyyTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee1111DDDD and ffffggggllllCCCCooooppppyyyyTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee1111DDDDEEEEXXXXTTTT are not supported on
  110.      RealityEngine, RealityEngine2, and VTX systems.
  111.  
  112.      On InfiniteReality systems, there is a performance benefit when the width
  113.      of the image to be transferred to texture memory is a multiple of 8.
  114.  
  115.      Texture borders are not supported on InfiniteReality systems.
  116.      Applications should use borderless textures and GGGGLLLL____CCCCLLLLAAAAMMMMPPPP____TTTTOOOO____EEEEDDDDGGGGEEEE____SSSSGGGGIIIISSSS
  117.      wrap mode.
  118.  
  119.      On High Impact and Maximum Impact systems, if the right side of the image
  120.      to be transferred to texture memory is not the right side of the texture,
  121.      then its index must be a multiple of 32, where index = xoffset+width.
  122.      Otherwise it will generate a GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE error.
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.                                                                         PPPPaaaaggggeeee 2222
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137. ffffggggllllCCCCooooppppyyyyTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee1111DDDD((((3333GGGG))))       OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee       ffffggggllllCCCCooooppppyyyyTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee1111DDDD((((3333GGGG))))
  138.  
  139.  
  140.  
  141. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  142.      ffffggggllllCCCCooooppppyyyyPPPPiiiixxxxeeeellllssss, ffffggggllllCCCCooooppppyyyyTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD, ffffggggllllCCCCooooppppyyyyTTTTeeeexxxxIIIImmmmaaaaggggeeee2222DDDD,
  143.      ffffggggllllCCCCooooppppyyyyTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee2222DDDD, ffffggggllllPPPPiiiixxxxeeeellllSSSSttttoooorrrreeee, ffffggggllllPPPPiiiixxxxeeeellllTTTTrrrraaaannnnssssffffeeeerrrr, ffffggggllllTTTTeeeexxxxEEEEnnnnvvvv,
  144.      ffffggggllllTTTTeeeexxxxGGGGeeeennnn, ffffggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD, ffffggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee2222DDDD, ffffggggllllTTTTeeeexxxxPPPPaaaarrrraaaammmmeeeetttteeeerrrr,
  145.      ffffggggllllTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee1111DDDD, ffffggggllllTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee2222DDDD
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.                                                                         PPPPaaaaggggeeee 3333
  197.  
  198.  
  199.  
  200.